docs(showcase): reorganize pages by authoring model for teaching (Start Here + kind-grouped nav)#2498
Merged
Merged
Conversation
…rt Here + kind-grouped nav) Page `kind` keeps iterating (full/slotted · html · react), but the showcase had no map: 29 pages in one flat "Pages" group, 6 overlapping react pages, 1 html page, and nowhere that teaches WHICH kind fits WHICH scenario. Reorganize the showcase to teach the decision. - New **Start Here** default landing (`examples/.../start-here.page.ts`): a `kind:'html'` teaching index — two-axis model (type × kind), a decision tree (catalogue→full/slotted · custom layout→html · interactivity→react), and four cards linking to the canonical example of each. Doubles as the 2nd html example. Browser-verified: renders + cards navigate. - **Nav grouped BY KIND**: replace the flat "Pages" dump with Authoring · Structured / · Visualizations / · HTML / · React, so the authoring models are visible at a glance. Start Here pinned at the top; component-gallery loses its default flag. - **React consolidated 6 → 4**, each teaching one react-only capability: CRM Workbench · master/detail, Task Desk · drawer & modal, Account Cockpit · live rollup, Renewals Pipeline · record blocks. Drop inquiry-triage + invoice-console (their tabs/KPI patterns are covered by the kept pages and the Task Triage / structured interface pages). - Labels show the teaching point; the Start Here decision tree is the single source for "which kind when". os validate + tsc green; no Tailwind in the new html page (ADR-0065 guardrail clean). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Page
kindkeeps iterating (full/slotted · html · react), but the showcase had no map: 29 pages in one flat "Pages" group, 6 overlapping react pages, 1 html page, and nowhere that teaches WHICH kind fits WHICH scenario. This reorganizes the showcase so it actually teaches the decision.Changes
New
Start Heredefault landing — akind:'html'teaching index: the two-axis model (type×kind), a decision tree (catalogue → full/slotted · custom layout → html · interactivity → react), and four cards linking to the canonical example of each. It doubles as the second HTML-tier example. Browser-verified: renders correctly, cards navigate.Nav grouped BY KIND — the flat "Pages" group becomes Authoring · Structured / · Visualizations / · HTML / · React, so the authoring models are visible at a glance.
Start Hereis pinned at the top; Component Gallery loses its default flag.React consolidated 6 → 4, each teaching one react-only capability:
Dropped
inquiry-triage+invoice-console— their tabs / KPI-filter patterns are already covered by the kept react pages and by the structured Task Triage interface page, so they added overlap, not teaching value.Labels show the teaching point; the Start Here decision tree is the single source for "which kind, when".
Verification
os validate+tsc --noEmitgreen; the new html page has no Tailwind (ADR-0065 guardrail clean).🤖 Generated with Claude Code